Carbon


GetThemeDrawingState

Header: Appearance.h Carbon status: Supported

Obtains the drawing state of the current graphics port.

OSStatus GetThemeDrawingState (
    ThemeDrawingState *outState
);
outState

A pointer to a value of type ThemeDrawingState. On return, GetThemeDrawingState sets the outState parameter to point to a copy of the drawing state for the current graphics port.

function result

A result code.

DISCUSSION

Your application may call the GetThemeDrawingState function before performing an operation that modifies the drawing state of a graphics port. To return the graphics port to its previous drawing state and release the memory allocated for the drawing state reference, your application should call SetThemeDrawingState, providing the reference obtained in the outState parameter of GetThemeDrawingState. You can also call DisposeThemeDrawingState to release the allocated memory.

VERSION NOTES

This function is available with Appearance Manager 1.1 or later.

AVAILABILITY

Supported in Carbon. Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.


© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)